home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / grafik / 3d & render tools / xpgs-2.5 / install < prev    next >
Encoding:
Text File  |  1996-07-16  |  4.6 KB  |  109 lines
  1.  
  2.  
  3. The basic requirements are:
  4.   ANSI C compiler;
  5.   Xlib R4/5/6, maybe even R3 and m(ath) libraries.
  6.  
  7. If you have no access to an ANSI C compiler then read this:
  8.   An ANSI C compiler is not strictly necessary with a suitable utility such
  9.   as ansi2knr or unproto and a little editing the programs should compile on
  10.   most systems. The ANSI C facilities used include constant string
  11.   concatenations as well as the prototypes. I wrote in this flavour of C
  12.   because it's what I started out learning and the compiler checks are very
  13.   useful.
  14.  
  15. Machines tested:
  16.   486DX2/66 PC under Linux 1.0.9 w/ XFree-3.1 and gcc 2.5.8
  17.   HP9000/735 & HP9000/720 under HPUX-9.01
  18.   DEC Alpha/Vax under VMS 6.1
  19.   DEC Alpha under OSF/1 2.1
  20.   Sun sun4m machine running under SunOS 4.1.3 with acc
  21.     (previous xpgs version only)
  22.  
  23. Procedure for compiling:
  24.   There are four compiler definitions you can choose - XPGSUSEPM, XSSUSEPM,
  25.   EUROPPR and SILLYRAND options.
  26.  
  27.   The first option depends on how you want xpgs to animate the SIRDSs, your
  28.   choice dictates whether the X server's pixmaps are used or not. If you
  29.   have a crappy X server, (for instance a lowly X terminal) then you will
  30.   not want to use pixmaps. Internally, the choice is between server-side
  31.   pixmaps and client-side images. The downside to disabling pixmaps is that
  32.   the animation will not be guaranteed to run at full speed - it may be
  33.   rather jerky or slow.
  34.  
  35.   The second option is similar to the first option but applies to xss. Since
  36.   xss uses a limited number of pixmaps, it should be possible to run xss
  37.   with this option compiled on an X terminal. If you miss out this option
  38.   then the display will be quite flickery.
  39.  
  40.   The third option defines the paper type you want to use in the PS dumps.
  41.   If it is defined then xpgs and vpgs will use the international standard
  42.   A4, otherwise they will use the US letter size (8.5x11).
  43.  
  44.   The final option (SILLYRAND) is defined when the random number generator,
  45.   used by sisgen, vpgs & sisgen, has a poor distribution in the lower bits.
  46.   For instance, the numbers returned may alternate between odd and even.
  47.   This returns in a SIRDS which looks stripy. In fact if the backgrounds of
  48.   the SIRDS does not like very random then you should try recompiling the
  49.   programs with the option defined.
  50.  
  51. Unix machines
  52. =============
  53. There are two alternatives:
  54.  
  55. 1) Copy the Makefile.std to Makefile, eg "cp Makefile.std Makefile". Then
  56.    edit the Makefile according to the computer you're using by commenting
  57.    out and putting in the compiler options appropriately. Make sure that the
  58.    paths to the X stuff is correct.
  59.  
  60.    Execute the command "make" and all is done. Copy the data files,
  61.    executables and man pages to their usual places, eg.
  62.    /usr/local/lib/xpgs/polyh, /usr/local/bin & /usr/local/man/man6 if you
  63.    have sufficient privilege otherwise put them in your own directory tree.
  64.  
  65. 2) Edit the Imakefile putting in the install paths. Add any compiler options
  66.    you deem necessary.
  67.  
  68.    Execute the commands "xmkmf" and "make". If you wish to install the
  69.    executables, man pages and data files then use "make install"
  70.  
  71. At runtime, you can define an environment variable XPGS_DIR to point to the
  72. polyh files. Eg. use "XPGS_DIR=/usr/local/lib/xpgs/polyh; export XPGS_DIR"
  73. for sh or ksh or bash and "setenv XPGS_DIR /usr/local/lib/xpgs/polyh" for
  74. csh and its ilks.
  75.  
  76. DEC VMS machines
  77. ================
  78. There are (also) two alternatives :
  79.  
  80. 1) Edit the make.com and choose the options you want. Then just execute the
  81.    command file make.com by "@make".
  82.  
  83. 2) Edit descrip.mms. Then use either mms or mmk (Matt Madison's free
  84.    alternative).
  85.  
  86. To run either define a global symbol for a foreign command, eg.
  87. xpgs:==$disk:[user.bin]xpgs etc or use the command mcr eg. mcr []xpgs etc.
  88. Note that if you want to use options that have capital (or uppercase)
  89. letters then they must be quoted, eg. mcr []xpgs "-S" cub
  90.  
  91. At runtime, you can define a logical XPGS_DIR to point to the polyh files.
  92. Use "define XPGS_DIR disk:[user.data.polyh]", for example.
  93.  
  94. Problems and notes
  95. ==================
  96. From past experience, I know a lot of gcc installations (on Sun's especially)
  97. are misconfigured: header files, etc are wrong.
  98.  
  99. So please check 1) that your compiler is properly installed and 2) the
  100. header files are ANSI C compliant - that is they have the symbols specified
  101. in K&R 2nd Ed and the standard libraries. I've put in a few hacks in misc.h
  102. and pgs.h to circumvent some errors.
  103.  
  104. The only non standard C call (apart from Xlib) is to the select() function
  105. (or in VMS lib$wait()) in xpgs.c for timing the animation. This and its
  106. associated struct's should be declared and defined through Xos.h. The string
  107. functions str*() are declared throughout using string.h.
  108.  
  109.